home *** CD-ROM | disk | FTP | other *** search
/ Creative Computers / Creative Computers CD-ROM, Volume 1 (Legendary Design Technologies, Inc.)(1994).iso / commercial / inovatronics / candodemo / testdrivemanual / testdrive1.doc < prev    next >
Text File  |  1994-11-17  |  26KB  |  606 lines
  1. **** CANDO TEST DRIVE #1
  2.  
  3.     When you first start CanDo, your Card's default window is
  4. low-resolution, 320 by 200, with 16 Colors.  However, you can tell
  5. CanDo to open a Window of any dimension and display mode supported by
  6. the Amiga Operating System or you can simply tell it to use a standard
  7. Picture as a background.  When a picture window is used, CanDo will
  8. automatically load and display the picture in your Card's Window and
  9. set the color palette.  You will use a picture window for this
  10. example.  Click the Window Icon on the main Panel.
  11.  
  12.     See Picture "Images/WindowIcon"
  13.  
  14.     This will display the Window Editor.  Change the Window Title from
  15. "Unnamed..." to "Test Drive 1"
  16.  
  17.     See Picture "Images/WindowTitle"
  18.  
  19. Click on the Dimension Button.
  20.  
  21.     See Picture "Images/Dimension"
  22.  
  23.     This will display the Dimension Requester.  This Requester allows
  24. you to specify the Dimensions and the number of colors for your window
  25. or you can specify a Picture.  The Dimension and number of colors will
  26. be determined by the picture.
  27.  
  28.     The button entitled "Unnamed" below "Picture" indicates there is
  29. not yet a Picture specified for the window.  Click on the "Unnamed"
  30. Button.
  31.  
  32.     See Picture "Images/UnnamedPicture"
  33.  
  34.     This will bring up CanDo's File Requester.  The Title at the top
  35. will say "Image Requester".  The File field displays the selected File
  36. Name.  Select Backdrop1.PIC by clicking on it in the list of files.
  37. Click on the Show Picture Button.  This allows you to preview the
  38. picture.
  39.  
  40.     This picture is a simple brown rectangle with a black drop shadow.
  41. This type of picture can be used for creating many kinds of attractive
  42. applications.  When you are ready to proceed, click anywhere on the
  43. picture.
  44.  
  45.     This will return you to the File Requester.  When you Click Ok you
  46. will return to the Dimension Requester.  Notice the button, which said
  47. "Unnamed", is now highlighted with the text "Backdrop1.Pic".  This
  48. verifies you now have a Picture window.  Click Ok and return to the
  49. Window Editor.  You will explore the other aspects of the Window
  50. Editor later.  Click Ok.  This will return you to the Main Panel and
  51. display your new window.  Click on the Screen Up/Down Button so you
  52. can see more of your window.
  53.  
  54.     See Picture "Images/UpDownIcon"
  55.  
  56.     The picture you previewed should now be shown along with window
  57. borders, a Close Button, and a window title of "Test Drive 1".  This
  58. is the canvas to which you will be adding various "Objects" while
  59. learning about CanDo.
  60.  
  61.     The first thing you will do is add a button to your window.  On
  62. the Main Panel, click on the Screen Up/Down Button to raise the Main
  63. Panel, click on Add Icon and then click on the Button Icon.
  64.     
  65.     See Picture "Images/AddIcon"
  66.     See Picture "Images/ButtonIcon"
  67.  
  68.     A requester appears with a brief description, which will serve as
  69. a reminder of what you need to do to add a button.  The process for
  70. defining the button area is to position a cross-hair pointer to where
  71. you want the upper left corner; press and hold the left mouse button;
  72. drag the pointer to the right and down; when the rectangle is the size
  73. and shape you wish, release the mouse button.
  74.  
  75.     Click Ok on the reminder requester.  CanDo's Main Panel will
  76. completely disappear.  Your mouse pointer is now a cross-hair.
  77.  
  78.     Notice a pair of numbers which follow the mouse pointer.  These
  79. numbers are the "Coordinates" of the current mouse position.  The
  80. first number is the horizontal position (distance from the left), and
  81. the second number is the vertical position (distance from the top).
  82.  
  83.     Position the cross-hairs where the coordinates will be near 90,50.
  84. This will be near the upper left corner of the brown box.
  85.  
  86.     Click and Hold the left mouse button.  Notice the numbers with the
  87. mouse button have changed to 1,1.  These numbers represent the size of
  88. the button area.
  89.  
  90.     Drag the cross-hairs down and to the right about an inch in both
  91. directions.  When you release the mouse button, the Button Editor will
  92. appear.
  93.  
  94.     The default border for a button is a simple outline.  This is
  95. indicated by the text OUTLINE in the button below the "Border" title.
  96. Click on the OUTLINE button.
  97.  
  98.     See Picture "Images/OutlineBorder"
  99.  
  100.     This will display the Border Requester.  This requester contains
  101. twelve border styles you can use.  The title "Outline" is highlighted
  102. indicating it is the currently selected border style.  Click on the
  103. Bevel style.
  104.  
  105.     See Picture "Images/BevelBorder"
  106.  
  107.     This will cause the title "Bevel", above the sample border, to
  108. become highlighted.  The Bevel style uses two colors.  They can be any
  109. color in the color palette.  The colors in the palette are shown along
  110. the bottom of the screen.  Click on a couple of these colors.  Notice
  111. the color changes in the displayed borders.  The color in the 1st
  112. color selector (the TV looking box in the Border Requester) will
  113. reflect the selected color.  Click on White in the color palette.  Now
  114. Click on the 2nd Color Selector.
  115.  
  116.     See Picture "Images/2ColorSelectors"
  117.  
  118.     This will cause a black outline to appear around the 2nd Color
  119. Selector.  Click on various colors in the color palette and observe
  120. the changes in the sample borders.  Now Click on Black (3rd from left)
  121. in the color palette.  Look at the Bevel border example.  This is the
  122. natural appearance of the Bevel Style:  a light shade on the top and
  123. left, and a dark shade on the bottom and the right.  Click on the Ok
  124. Button.
  125.  
  126.     This will bring you back to the Button Editor.  Click Ok.  This
  127. will return you to the Main Panel and your window will now contain
  128. your new button.  Click on Browse.
  129.  
  130.     Click on your newly created button.  While in "Browse" Mode, you
  131. can test your application.  You have not told your button to do
  132. anything yet, so it will simply change color when you click on it.
  133. Click on the Edit Button.
  134.     
  135.     See Picture "Images/BrowseIcon"
  136.  
  137.     Notice both the Edit Button and the Design Button have become
  138. highlighted.  When you click on your button, while in "Design" mode,
  139. you will automatically go to the Button Editor.
  140.  
  141.     See Picture "Images/EditIcon"
  142.  
  143.     You will be instructing your button to display a Text message when
  144. you click and "Release" on it.  CanDo allows you to define an action
  145. for each of the Amiga supported actions for a button:  Click, Drag,
  146. Release, and DoubleClick.  The Release action is commonly used in
  147. Amiga applications for allowing the user to click on a button, change
  148. their mind, and remove the mouse pointer before releasing the mouse
  149. button; thus avoiding the button's action.  You will be using the
  150. Release action for this button.
  151.  
  152.     If you have not done so already, click on your button.  When the
  153. Button Editor appears, click on the Release button under Scripts.
  154.  
  155.     See Picture "Images/Release"
  156.  
  157.     This will bring up the Script Editor.  At this point you could
  158. type in the instructions to print a text message on the screen.
  159. However, CanDo has some tools to help you write scripts for some
  160. common activities.  These tools are called Editor Tools (not all of
  161. CanDo's Editor Tools have been included in the Test Drive).  Along the
  162. right edge of the Script Editor are four Editor Tool Icons.  Using the
  163. Slider, on the far right, you can find additional Editor Tool Icons.
  164.  
  165.     Using the Editor Tool Slider, locate the Print Text Editor Tool
  166. Icon and click on it.
  167.  
  168.     See Picture "Images/Text_ET_Icon"
  169.  
  170.     The Print Text Requester will appear.  Click on the "Set Text and
  171. Font..." button.
  172.  
  173.     See Picture "Images/SetTextAndFont"
  174.  
  175.     This will bring up the Font/Text Requester.  Enter "The Button Got
  176. Clicked!" into the Text Field and press Return.  Notice the example
  177. text on your window.  This is what the text will look like when it is
  178. printed.  Click on the Outlined Button.
  179.  
  180.     See Picture "Images/Outlined"
  181.  
  182.     Click the Ok Button.  This will return you to the Print Text
  183. Requester.  Now, click the "Set Position..." button.
  184.  
  185.     See Picture "Images/SetPosition"
  186.  
  187.     The Script Editor will disappear allowing you to position a
  188. rectangle the size and shape of your text message.  Position the box
  189. to the right of your button near 350,50.  These coordinate numbers
  190. will tag along with your mouse pointer.  Click and release the mouse
  191. pointer when it is properly positioned.  This will return you to the
  192. Print Text Requester.  You can